Skip to content

docs: add AADSTS700046 troubleshooting for Copilot Components in production M365 Copilot - #10943

Closed
Vilius Vystartas (vystartasv) wants to merge 1 commit into
SharePoint:mainfrom
vystartasv:fix/10942-copilot-aadsts700046
Closed

docs: add AADSTS700046 troubleshooting for Copilot Components in production M365 Copilot#10943
Vilius Vystartas (vystartasv) wants to merge 1 commit into
SharePoint:mainfrom
vystartasv:fix/10942-copilot-aadsts700046

Conversation

@vystartasv

Copy link
Copy Markdown

Closes #10942

Problem

When a Copilot Component is deployed to production Microsoft 365 Copilot, the component iframe fails during preload with:

AADSTS700046: Invalid Reply Address. Reply Address must have scheme
brk-<tenant-id>:// and be of Single Page Application type.

The same component works correctly in the Copilot Workbench. The issue is that the brk-<tenant-id>://m365.cloud.microsoft redirect URI is not registered on the SharePoint Online Web Client Extensibility Azure AD application.

Fix

Added a Troubleshooting section to the deployment guide with:

  • Error identification (error text, symptoms)
  • Root cause explanation
  • 5-step workaround to register the reply URI in Azure AD
  • Preview caveat note

Changes

 docs/spfx/copilot/get-started/build-your-first-copilot-app.md | 24 +++++++++
 1 file changed, 24 insertions(+)

…uction M365 Copilot

Adds a troubleshooting section to the 'Build your first SharePoint Copilot App'
tutorial covering the invalid_client / AADSTS700046 error that occurs when a
Copilot Component iframe loads in production Microsoft 365 Copilot.

Documents the brk- scheme reply URI and provides step-by-step instructions
for tenant administrators to register it in Azure AD.

Closes SharePoint#10942
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit ab700fa:

✅ Validation status: passed

File Status Preview URL Details
docs/spfx/copilot/get-started/build-your-first-copilot-app.md ✅Succeeded View

For more details, please refer to the build report.

@jansenbe

Copy link
Copy Markdown
Contributor

Vilius Vystartas (@vystartasv) / Andrew Connell (@andrewconnell) : this is not the reply URL that should be added. The needed reply URL will be added automatically, let's hold with providing manual workarounds for now.

@andrewconnell Andrew Connell (andrewconnell) added the pr:do-not-merge Pull request not ready to be merged label Jul 14, 2026
@andrewconnell

Andrew Connell (andrewconnell) commented Jul 14, 2026

Copy link
Copy Markdown
Collaborator

Bert Jansen (@jansenbe) should this be closed without merging based on your response?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pr:do-not-merge Pull request not ready to be merged

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[SharePoint Copilot Apps preview] AADSTS700046 "Invalid Reply Address" (brk- scheme) when component loads in production Microsoft 365 Copilot

3 participants